3D Graphics Programming with QuickDraw 3D 1.5.4

Submit Method

This section describes the renderer geometry submit method.

TQ3XRendererSubmitGeometryMethod

The TQ3XRendererSubmitGeometryMethod renderer support functionality is required.



 
#define kQ3XMethodTypeRendererSubmitGeometryMetaHandler

                     Q3_METHOD_TYPE ('r','d','g','m')



 
typedef TQ3XFunctionPointer

                     (*TQ3XRendererSubmitGeometryMetaHandlerMethod)(

                     TQ3ObjectType    geometryType)



 
typedef TQ3Status (*TQ3XRendererSubmitGeometryMethod)(

                     TQ3ViewObject        view,

                     void                 *rendererPrivate,

                     TQ3GeometryObject    geometry,

                     const void           *publicData);

geometryType: A geometric object type (see "About Geometric Objects" ).
view: The current view being rendered to.
rendererPrivate: A pointer to structure of size instanceSize , passed into Q3ObjectHierarchy_RegisterClass , and initialized in your kQ3MethodTypeObjectNew method.
Objectgeometry: The geometry for which this call was registered. It must be a geometry object containing publicData , or NULL if this call was made in immediate mode.
publicData: A pointer to the public data structure associated with Objectgeometry. This pointer is passed into Submit calls, so the data may become invalid after TQ3XRendererSubmitGeometryMethod exits. If Objectgeometry is not null , you may call Q3Shared_GetReference and save the publicData pointer to preserve the information. In this case, call Q3Object_Dispose on the geometry when you are through.

DESCRIPTION

The method type kQ3XMethodTypeRendererSubmitGeometryMetaHandler returns a function pointer of type TQ3XRendererSubmitGeometryMetaHandlerMethod. This function enables a geometry of type geometryType and returns methods of type TQ3XRendererSubmitGeometryMethod.

This renderer functionality is required, and it must support the following geometric object types:



 
    kQ3GeometryTypeTriangle

    kQ3GeometryTypeLine

    kQ3GeometryTypePoint

    kQ3GeometryTypePixmapMarker